DEVICE DATASTORE

The DATASTORE device, is used to manage the reads and writesof the removable memory MMC (Multi Media Card) and in the non-removable memory (NAND) of the Qmove family instruments.

In the configuration unit, the BUS section must be declared so that you have the hardware resources required for the implementation of the DATASTORE device.

;---------------------------------
; Internal device declaration
;---------------------------------
INTDEVICE
<device name>    DATASTORE          TCamp          <port_type>

where:

;--------------------------------
; Internal device declaration
;--------------------------------
INTDEVICE
DEV        DATASTORE        0001        0

The access to MMC storage device, it is implemented through a “file_system” and not with direct access. In this way the saved data can be shared with any PC and the device is seen by it as a simple floppy disk.

File system features The file system supports the following types of FAT:
FAT12 Used on floppy disks or storage devices with limited capacity.
FAT16 Used in most storage devices. It can get to store 2 GB of data.
FAT32 Used in high-capacity storage devices, over 2 GB.

The file-system implemented, allows access to the file for reading and writing. Does not allow you to create directories, and then those files must be present in the single “root directory” . The device is also able to open/create files whose names or ASCII conversion of a number and the extension is fixed.

Supports two types of files:

• BINARY format: the file is written directly as if it were an array of long (“.hex” extension);
• CSV format (Comma Separated Values): data is written to a table with a number of columns can be set. The data are separated by “;” or is on a maximum number of characters for any data (fixed number).

Supported file formats are the BINART and the CSV. In our implementation are available the reading and appending functions (writing to END file), but not overwrite function on all types of files.

BINARY format The binary files have “hex” extension. In our implementation you can write and read a binary file where data values are stored in long (32bits) in hexadecimal base (HEX). To write or read such a file you must set the parameter filetype = 0.

If in the olongXX variables we have the following values:

olong01 = 0 => H'00000000
olong02 = -1 => H'FFFFFFFF
olong03 = 10000 => H'00002710
olong04 = -10000 => H'FFFFD8F0

We run the WRITE command by setting the parameter “field = 4”, we get to the end of the file:

00000000FFFFFFFF00002710FFFFD8F0''

CSV format The csv file will have “csv” extension. Data written in these files are organized in a table formed from a settable number of columns, each column is called a “field”. The rows of the table are called “record”. The DATASTORE device does not consider the presence of the record header. The maximum number of field is set to 32 (ilong / olong).

To write some long data type, “10000”, “-1”, “2147483647” and “-2147483648”, by setting the “filetype = 1” parameter, we will have:
The file system supports the following types of FAT:

Field1------------ +Field2--------- +Field3-------- +Field4-----+
10000              -1               2147483647      '2000000000

In this way the occupation of space in each record is fixed. If we set instead “filetype = 3”, we will have:

10000;-1;2147483647;'2000000000

The major evaluation software including Microsoft Excel, OpenOffice, Lotus 123, successfully read the fixed width file (filetype = 1) but when you save it into file with the field delimiters (filetype = 3).
The main difference between a format and the other is in the search of records.
Read a particular record using the format 1, It is not difficult as the start position within the file can be calculated easily given the record length is fixed.
Read instead a record with the format 2, implies a search within the file record start position. This operation may be long.

To use the (MMC) storage device You must use the device command that allows to recognize it and activate it. The MOUNT command allow to execute this operationn. The device will be activated when the state st_mount take the value 1.
Please note that after each command, the device marks is handling that command with the st_busy state. When the st_busy state is to 1 the device cannot access other commands.
To open an existing file or open a new file, set the filetype parameter. It allows you to specify the format of the file you intend to treat.
Below we will divide the discussion on whether the filetype parameter takes the following values:
a) 0: binary files;
b) 1-2: CSV file with fixed space for data;
c) 3-4: CSV file with data separated by “;”.
Before sending the command of opening the file you have to specify which file is open with the filenuum parameter.
If the file is present in the storage device it is open otherwise it creates a new file with the name specified in filenum file.
When the st_openfile state is to 1 the file is opened.

a) In the binary files data is present one after the other. It's possible:

• Add a data in queued;
• overwrite a given already in the list (knowing the location).

To read one or more data to a binary file, you must set the record parameter what data you begin reading and in the filed parameter how much data to read up to 32 data with one reading. At this point you have to use the READ command.
Data read are shown in the ilong01÷ ilong32 parameters.

Reading of 3 data in the position 11, 12, 13 in the binary file.

DEV:record=11
DEV:field=3
READ DEV
WAIT NOT DEV: st_busy
glVar1=DEV: ilong01
glVar2=DEV: ilong02
glVar3=DEV: ilong03

To write one or more data to a binary file you must set therecord parameter what data start overwrite and in the field parameter how much data will overwrite.
Data values by overwriting the data in the file should be inserted into olong01÷ olong32 parameters.

Writing of 3 datas int the position 11, 12, 13 in the binary file.

DEV:record=11
DEV:field=3
DEV:olong01=123        ;first data
DEV:olong02=456        ;second data
DEV:olong03=789        ;third data
WRITE DEV
WAIT NOT DEV: st_busy

To append new data to a binary file, you must use the method described above remembering to set the record parameter to -1.

B) In the CSV files with fixed datas space, is creates a table with columns, called field, and rows, called record. The field numbers with which to create the table you must specify before you open the new file in the field parameter.
For each entry in this table is reserved a fixed space. In this way each record, composed of a number field of data, fixed space in file.
To read a record of such a file, you must set in the record parameter, the number of records to read and send the READ command. In the ilong01-ilong32 parameters, are shows the read values from the record.

To overwrite a record of such a file, set the parameter records the number of records to write, set in the olong01-olong32 paramenters a number of values equal to the number of field in the record and then send the WRITE command.
To append a new record to the file you must set the value -1 in record.

Lettura del record 3 (Composto di tre field):

DEV:record = 3
READ DEV
glVar1 = DEV:ilong01
glVar2 = DEV:ilong02
glVar3 = DEV:ilong03

C) Come nel caso B, ma in questo caso non è possibile leggere o sovrascrivere un particolare record. E' possibile solo leggere in modo sequenziale tutto il file e scrivere solo aggiungendo un nuovo record.

Tabella riassuntiva:

* = READ record sequenziali: lettura dei record presenti nel file partendo dal primo record fino all'ultimo. Questo tipo di lettura non prevede la possibilità di leggere record in ordine casuale all'interno del file. Questo tipo di lettura prevede solo di leggere i record partendo dal primo e leggendo sempre il successivo all'ultimo letto
* * = READ record indicizzati: questo tipo di lettura permette di leggere qualsiasi record presente nel file anche in ordine casuale.

Il nome del parametro, stato o comando è riportato alla sinistra della tabella.

R
Indica se il relativo parametro o stato è ritentivo (al momento dell’inizializzazione del device mantiene lo stato precedentemente definito), oppure lo stato che assume al momento dell’inizializzazione del device.
Se il device non necessita d'inizializzazione il campo “R” indica il valore che il parametro o stato assume all’accensione della scheda.
R = Ritentivo
0 = Al momento dell’inizializzazione del device il valore è forzato a zero.
1 = Al momento dell’inizializzazione del device il valore è forzato a uno.
- = Al momento dell’inizializzazione del device è presentato il valore significativo.

D
Indica la dimensione del parametro.
F = Flag
B = Byte
W = Word
L = Long
S = Single Float

Sono descritte tutte le condizioni necessarie affinché il parametro sia considerato corretto o perché il comando sia accettato.
In alcuni casi sono specificati dei valori limite per l’accettazione del parametro: se sono introdotti dei valori esterni ai limiti impostati, il dato è in ogni caso accettato; pertanto devono essere previsti opportuni controlli dell’applicativo tali da garantire il corretto funzionamento.
Per l’esecuzione di un comando, tutte le relative condizioni devono necessariamente essere soddisfatte; in caso contrario il comando non è inviato.

A
Indica il modo d'accesso.
R = Read (lettura).
W = Write (scrittura).
RW,= Read / Write.

Di seguito sono presentati i parametri, variabili, stati e comandi necessari all’esecuzione del device.

I dati tipo SINGLE non sono trattati. È necessario convertire questi dati di tipo interno prima di trasferirli nella MMC.

WAIT NOT DEV:st_busy               ; necessaria perché il device alla momento del RUN
                                   ; è in uno stato di busy finchè non termina
                                   ; le operazioni di inizializzazione.
MOUNT DEV                          ; esegue il MOUNT del dispositivo
WAIT NOT DEV:st_busy               ; attende il termine dell’operazione
IF DEV:st_mount                    ; se il dispositivo è presente,
  <operazioni>                     ;lo stato st_mount è 1
ENDIF

DEV:filetype = 0                   ; imposta il tipo di file BINARY
DEV:filenum = 123                  ; imposta il nome del file come “123.hex”
WAIT NOT DEV:st_busy
OPENFILE DEV                       ; esegui il comando di apertura
WAIT NOT DEV:st_busy               ; attende il termine dell’operazione
IF DEV:st_openfile                 ; se il file viene aperto correttamente,
  <operazioni>                     ;lo stato st_openfile è 1
ENDIF

DEV:field = 2                      ; imposta il numero di campi di cui
                                   ; è composto il record
                                   ; Nota: se il tipo di file è BINARY,
                                   ; questo parametro indica il numero di long
                                   ; che verranno scritte/lette.
DEV:record = -1                    ; indica al device di eseguire l’operazione a
                                   ; partire dalla fine del file (accodamento).
DEV:olong01 = 123456               ; imposta il dato da scrivere
DEV:olong02 = 654321
WAIT NOT DEV:st_busy
WRITE DEV                          ; esegui il comando di scrittura
WAIT NOT DEV:st_busy               ; attende il termine dell’operazione
IF DEV:st_error                    ; verifica se ci sono stati errori in scrittura
  <errore>
ENDIF